<HTML>

<HEAD>
	<TITLE>EETransfer Off-line documentation</TITLE>
</HEAD>

<BODY BACKGROUND="../pict/fond.gif" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#FF0000" VLINK="#FF0000">

<TABLE WIDTH=598 BORDER=0 CELLPADDING=0 CELLSPACING=0>


<TR >
		<TD WIDTH=120 ALIGN="center" NOWRAP>
		<A HREF="mailto:mail@easter-eggs.com" >
		<IMG SRC="../pict/mailee.gif" ALT="Mail to EE" WIDTH=81 HEIGHT=19 BORDER=0>
		</A>
		</TD>

		<TD WIDTH=20 NOWRAP>
		</TD>
		
		<TD WIDTH=5 NOWRAP>
		</TD>
		
		<TD WIDTH=226  ALIGN="center" VALIGN="top" NOWRAP>
		<IMG SRC="../pict/logo.gif" WIDTH=100 HEIGHT=100 BORDER=0>
		</TD>


		<TD WIDTH=227 VALIGN="center" NOWRAP>
		<H1>EETransfer Off-line documentation</H1>
		<FONT SIZE=+2><B><A HREF="../docsum.html">Back to summary</A></B></FONT>
		</TD>
		


</TR>

<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bbar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>
	
<TR >
		<TD WIDTH=120 ALIGN="center" VALIGN="top">
		Updated 97/06/24
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  ALIGN="left" COLSPAN=2> 
		<FONT SIZE=+2><B>ReceiveZModem</B></FONT>
		<BR><HR>
<B>Receive one or several files using the ZModem protocol.</B>

<BR><BR>

If the file name of the received file ends with ".pkg", the file is
considered as a package.
<BR>
If the file name ends with ".pct", the file is considered as Macintosh
PICT file and is converted into a Newton picture.
<BR>
If the file name ends with ".nso", the file is considered as a
NewtonScript Object file and isconverted into a Newton object.
<BR>
Otherwise, the file is considered as a text file and is not converted.
<BR><BR>




<B>* allowCommands</B>

<BR>

<B>type:</B> boolean

<B>default value:</B> true

<BR>

Allows the sender to send any NewtonScript commands which are executed
immediately.
<BR><BR>
<I>This option is a security hole, so it may be disabled.</I>
<BR><BR>





<B>* charset</B>

<BR>

<B>type:</B> symbol
<BR>
<B>possible values:</B> defined in the file "EERecodeConstants.f"
<BR>
<B>default value:</B> kMacOSCharset ('mac)

<BR>

Defines which characters set is used for the file and the file name.
<BR>
This information is used to convert or show the file.
<BR><BR>




<B>* clientAppSymbol</B>

<BR>

<B>type:</B> symbol
<BR>
<B>default value:</B> nil

<BR>

AppSymbol of the application which intends to use this file.
<BR>
If clientAppSymbol equals nil, the appSymbol of the application currently
running the script will be used, so you will seldom have to override
clientAppSymbol default value.
<BR><BR>
<I>Note: if a file conversion occurs, the clientAppSymbol slot may be ignored
by EETransfer.</I>
<BR><BR>




<B>* convertTextFiles</B>
<BR>


<B>type:</B> boolean
<BR>
<B>default value:</B> nil

<BR>

If the file name ends with ".txt", and "convertTextFiles" is set to true,
the file is considered as a text file and is converted into a Newton text
object.
<BR>
Otherwise, the file is not converted.
<BR><BR>




<B>* encodeControlChars</B>


<BR>
<B>type:</B> boolean

<B>default value:</B> nil

<BR>

Encode control characters used by the ZModem protocol to allow operation
with some packet switched networks.
<BR><BR>




<B>* szString</B>

<BR>

<B>type:</B> string or nil

<B>default value:</B> nil

<BR>

Use this option if you want to send a command to the sender before
starting to receive.
<BR>
This option is useful if the Newton is connected to a Unix or DOS server
or a BBS.
<BR>
For example, if szString is set to "sz readme.txt\n", the Newton will
command the Unix server to send the file "readme.txt".
<BR><BR>




<B>* sendFirstZrinit</B>

<BR>

<B>type:</B> boolean

<B>default value:</B> true


<BR>
This option is a patch which needs only to be used when receiving files
from a UNIX server which uses the lsz command.
<BR>
Sometimes these systems will trash (core dump) when they receive the first
ZRINIT packet. If this occurs just set this option to nil.

<BR><BR>



<B>* transport</B>


<BR>
<B>type:</B> frame
<BR>
<B>default value:</B> nil

<BR><BR>

<I>The transport must always be EETransfer.</I>
<BR><BR>
<B>Note:</B> Before the script executes itself, the global variable "<B>transport</B>"
is automatically set to EETransfer. So if you don't use a slot
"<B>globalSymbols</B>" you don't have to (and you should not) provide a slot
"<B>transport</B>". Otherwise, the "<B>globalSymbols</B>" slot must contain a slot:
<BR>
<B>transport:</B> 'transport,


<BR><BR>

<B>* waitForOO</B>
<BR>
<B>type:</B> boolean
<BR>
<B>default value:</B> true
<BR>
Some versions of HyperTerminal, a Windows 95 program, seem to have a bug
which prevents them to send correctly the "OO" (Over and Out) sequence when
the "ReceiveZModem" has endend. So, if you are transfering from
HyperTerminal, set this option to nil, otherwise the "ReceiveZModem" will
wait a few seconds for the "OO" sequence and then generate a warning.
<BR><BR>

<B>* wantToUseCrc32</B>

<BR>

<B>type:</B> boolean
<BR>
<B>default value:</B> true

<BR>

If this option is set, the sender will be asked to use a CRC32 instead of
a CRC16.
<BR>
A CRC32 is safest but takes a little more time to calculate.
<BR>

		</TD>

		
</TR>

<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bbar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>


<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>

<TR >
		<TD WIDTH=120 >
		&copy;1997 Easter-eggs<BR>
		All trademarks mentioned are the property of their respective owners
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>
		
		<TD WIDTH=226  VALIGN="top">
		</TD>


		<TD WIDTH=227 ALIGN="right" VALIGN="top">
		</TD>
		


</TR>


</TABLE>

</BODY>

</HTML>